The CDFlist program allows you to selectively list all (or a subset
of) the variable data values from a CDF.  The values can be displayed at the
screen, output to a text file, or used to create a new CDF (the new CDF may
be a subset of the original CDF).

The user interface to CDFlist is contained on a
single screen which is divided into several fixed windows and
pop-up windows.  The Action Menu controls the execution of
the program. This menu allows you to move to a different
window, start the data output, browse a help file, or
exit the program.  You must return to this menu each
time you want to select a new variable, output option,
listing type, or input CDF.  This menu may be displayed
at any time by entering Ctrl-F.  Use the up and down
arrow keys to highlight a choice in the Action Menu and
then enter a carriage return to execute that function.
Two very important windows are the Keypad Definition
and Message windows. They contain information on keypad
functionality and program status/error messages.

When CDFlist is executed (and a CDF and/or directory is not
entered on the command line), you must first specify the
CDF you wish to list.  If you enter
a full disk/directory specification (without a CDF
name), all of the CDFs in the specified directory will
appear in a separate pop-up window.  Use the up and down
arrow keys to choose a CDF and then enter a carriage return
to list that CDF.

The Output window will then be
displayed with the valid choices.  Use the up and down
arrow keys to scroll up and down within the menu and then
enter a carriage return to select the desired output option.
If output to an ASCII file or CDF is selected, you will be
prompted for a file/CDF name.  You may enter any
file/CDF name valid for the operating system begin used
or accept the default file/CDF name that appears.  Do not enter a
file extension (it is automatically appended).  The file
extension for a generated text file is .dat.

The second window that remains constant on the screen is
the Variable Selection window.  This window allows the
user to select the variables that are
to be listed or put into a CDF along with any desired filters
on the variables.  You will automatically be
placed in this window after you have entered an output
option.  You can also enter this window by entering Ctrl-F
to bring up the Action Menu and then select
the Select Variables menu option.

There are three
fields on each line in the Variable Selection window: variable
name, minimum filter value, and maximum filter value.
You can move forward to the next field by entering a carriage
return or backwards to the previous field with a Ctrl-H.  You may
also use the up and down arrow keys to move vertically
through the fields.  When the cursor is positioned in
a variable name field, entering Ctrl-P will 
display the variables in the CDF in a pop-up
window.  Use the arrow keys to highlight a variable
and then enter a carriage return to select it.  You can quit the
pop-up window without selecting a variable by 
entering q (quit).  You may also use the u and d keys to
page up and down in the pop-up window.  The first line
in this pop-up menu contains **SELECT ALL**.
Selecting this item causes all of the
variables in the CDF to be selected.

After selecting a variable, the 
cursor is positioned in the minimum filter field.  A
filter is simply the range of data that you would like to
see from the selected variable.  If just specifying a 
minimum filter value is sufficient, a maximum filter value need not be
entered.  You do not have to enter a filter for each
selected variable.  For a line of output (or a set of CDF variable
values) to be written for a given record/indices, each filter must
be passed.  There are two ways to enter
minimum and maximum filters.  The first is by simply
entering the desired values in the appropriate fields.  The
second method can only be used for variables that
consist of a discrete set of values.
This method involves entering a Ctrl-P (when in the
desired filter field) which displays a
pop-up window that contains the discrete values for the variable.
The desired filter value may then be selected.

When all of the desired variables and
filters have been selected, enter Ctrl-F to display
the Action Menu.  Selecting Generate Output will cause
the listing or new CDF to be generated.  When CDFlist completes
the generation of the output, the Action Menu is redisplayed.
It may then be used to select a new CDF to list, respecify the output
option, select new variables/filters, get online help, or exit the
program.

NOTE:

If you are running CDFlist under UNIX, your terminal
output will be limited to 132 chars per line.  If too many variables
have been selected, the output to a terminal screen will be truncated.
Output to a file or CDF, however, will not be affected (as many variables
as desired may be selected).
